Skip to content

Improve analyze-and-plan skill quality (65% → 94%)#56

Merged
trieloff merged 10 commits intomainfrom
improve-analyze-and-plan
Apr 10, 2026
Merged

Improve analyze-and-plan skill quality (65% → 94%)#56
trieloff merged 10 commits intomainfrom
improve-analyze-and-plan

Conversation

@trieloff
Copy link
Copy Markdown
Contributor

@trieloff trieloff commented Apr 10, 2026

Improves the weakest-scoring skill in the repo using Tessl's --optimize workflow.

Changes

skills/aem/edge-delivery-services/skills/analyze-and-plan/SKILL.md

  • Description — added explicit "Use when..." clause and rich trigger terms (EDS, requirements, definition of done, scope work)
  • Content — replaced vague prompts with specific analytical questions, added a concrete acceptance criteria template with a worked Hero block example, added a validation checkpoint (Step 4)
  • Size — reduced from 232 → 132 lines by removing redundant sections and consolidating verbose passages

skills/aem/edge-delivery-services/skills/analyze-and-plan/resources/task-types.md (new)

  • Extracted the five task-type analysis guides (new block, variant, behavior modification, CSS-only, bug fix) into a dedicated resource file referenced by SKILL.md

Tessl Review Score

Before After
Description 57% 100%
Content 57% 85%
Overall 65% 94%

Copilot AI review requested due to automatic review settings April 10, 2026 10:21
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Improves the “analyze-and-plan” skill documentation to drive more structured requirements analysis and acceptance criteria for AEM Edge Delivery Services tasks.

Changes:

  • Expanded YAML frontmatter description and clarified “use when…” triggers for the skill.
  • Reworked the workflow to include a structured acceptance-criteria template and a validation checkpoint.
  • Extracted task-type analysis guidance into a new resources/task-types.md file.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 4 comments.

File Description
skills/aem/edge-delivery-services/skills/analyze-and-plan/SKILL.md Streamlines steps, adds a standardized acceptance criteria format + validation checklist, and references external resource docs.
skills/aem/edge-delivery-services/skills/analyze-and-plan/resources/task-types.md New consolidated task-type guidance referenced by the main skill doc.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread skills/aem/edge-delivery-services/skills/analyze-and-plan/SKILL.md Outdated
Comment thread skills/aem/edge-delivery-services/skills/analyze-and-plan/SKILL.md
Comment thread skills/aem/edge-delivery-services/skills/analyze-and-plan/SKILL.md
Comment thread skills/aem/edge-delivery-services/skills/analyze-and-plan/SKILL.md
@trieloff trieloff force-pushed the improve-analyze-and-plan branch from 6bcce2d to dc553f9 Compare April 10, 2026 10:29
@trieloff trieloff closed this in #58 Apr 10, 2026
@trieloff trieloff reopened this Apr 10, 2026
@trieloff trieloff requested a review from shsteimer as a code owner April 10, 2026 10:38
@trieloff trieloff force-pushed the improve-analyze-and-plan branch from dc553f9 to d90b0af Compare April 10, 2026 10:40
@trieloff trieloff force-pushed the improve-analyze-and-plan branch from d57aeb0 to 4433b97 Compare April 10, 2026 10:49
@trieloff trieloff force-pushed the improve-analyze-and-plan branch from 81087dc to 2a7e37d Compare April 10, 2026 11:54
Agent-Id: agent-cf9473ea-8773-40a5-a76b-4d4a3c1d69ea
Agent-Id: agent-4edc780f-88d7-41bb-9165-da69b54f9fe0
Linked-Note-Id: 4c1224e8-045f-4aa9-a90d-d304af6da437
Agent-Id: agent-47fa28be-5997-4350-aa63-93236a73a9a8
Linked-Note-Id: b26d1d82-8ddb-4918-be52-3d6b78f18af8
Agent-Id: agent-c1d2bcc9-d1ea-4b25-be60-9af5369cba63
Linked-Note-Id: 99d5b8bf-54aa-4131-8014-4aba9d273c6d
Augment Code and others added 6 commits April 10, 2026 16:27
Signed-off-by: Lars Trieloff <lars@trieloff.net>
Signed-off-by: Lars Trieloff <lars@trieloff.net>
Agent-Id: agent-799ea216-b518-49a7-871d-f851b2c8f1e4
Linked-Note-Id: 3e74f377-1037-43ba-9ab3-90b2d13864f1
Signed-off-by: Lars Trieloff <lars@trieloff.net>
Agent-Id: agent-3200527d-e95f-40b7-b6b4-0867f55897cc
Linked-Note-Id: 7ee09537-c8e4-4de5-ae2e-d8d48fb80821
Signed-off-by: Lars Trieloff <lars@trieloff.net>
@github-actions
Copy link
Copy Markdown

Tessl Eval Results

Triggered by commit eval: re-run after removing --workspace flag

@trieloff trieloff merged commit fb981c4 into main Apr 10, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants